Zen

Translation

English type: Plain text
The @var{procedure} supports the keyword arguments @code{inputs} and @code{outputs}. Each input (whether @emph{native}, @emph{propagated} or not) and output directory is referenced by their name in those variables. Thus @code{(assoc-ref outputs "out")} is the store directory of the main output of the package. A phase procedure may look like this:
348/3510 · 351

Sign in to save the translation.

English Slovak Actions
The @code{%build-inputs} variable is also generated in scope. It's an association table that maps the input names to their store directories.
Dostupná je aj premenná @code{%build-inputs}. Predstavuje tabuľku, ktorá priraďuje názvy vstupov k ich priečinkom v úložisku.
The @code{phases} keyword lists the sequential steps of the build system. Typically phases include @code{unpack}, @code{configure}, @code{build}, @code{install} and @code{check}. To know more about those phases, you need to work out the appropriate build system definition in @samp{$GUIX_CHECKOUT/guix/build/gnu-build-system.scm}:
Kľúčové slovo @code{phases} predstavuje postupnosť krokov zostavovacieho systému. Medzi bežné kroky patria @code{unpack}, @code{configure}, @code{build}, @code{install} a @code{check}. Ak chcete o týchto krokoch zistiť viac, musíte nájsť to správne zadanie zostavovacieho systému v @samp{$GUIX_CHECKOUT/guix/build/gnu-build-system.scm}:
(define %standard-phases
;; Standard build phases, as a list of symbol/procedure pairs.
(let-syntax ((phases (syntax-rules ()
((_ p ...) `((p . ,p) ...)))))
(phases set-SOURCE-DATE-EPOCH set-paths install-locale unpack
bootstrap
patch-usr-bin-file
patch-source-shebangs configure patch-generated-file-shebangs
build check install
patch-shebangs strip
validate-runpath
validate-documentation-location
delete-info-dir-file
patch-dot-desktop-files
install-license-files
reset-gzip-timestamps
compress-documentation)))
(define %standard-phases
;; Standard build phases, as a list of symbol/procedure pairs.
(let-syntax ((phases (syntax-rules ()
((_ p ...) `((p . ,p) ...)))))
(phases set-SOURCE-DATE-EPOCH set-paths install-locale unpack
bootstrap
patch-usr-bin-file
patch-source-shebangs configure patch-generated-file-shebangs
build check install
patch-shebangs strip
validate-runpath
validate-documentation-location
delete-info-dir-file
patch-dot-desktop-files
install-license-files
reset-gzip-timestamps
compress-documentation)))
Or from the REPL:
Alebo cez REPL:
(add-to-load-path "/path/to/guix/checkout")
,use (guix build gnu-build-system)
(map first %standard-phases)
@result{} (set-SOURCE-DATE-EPOCH set-paths install-locale unpack bootstrap patch-usr-bin-file patch-source-shebangs configure patch-generated-file-shebangs build check install patch-shebangs strip validate-runpath validate-documentation-location delete-info-dir-file patch-dot-desktop-files install-license-files reset-gzip-timestamps compress-documentation)
(add-to-load-path "/path/to/guix/checkout")
,use (guix build gnu-build-system)
(map first %standard-phases)
@result{} (set-SOURCE-DATE-EPOCH set-paths install-locale unpack bootstrap patch-usr-bin-file patch-source-shebangs configure patch-generated-file-shebangs build check install patch-shebangs strip validate-runpath validate-documentation-location delete-info-dir-file patch-dot-desktop-files install-license-files reset-gzip-timestamps compress-documentation)
If you want to know more about what happens during those phases, consult the associated procedures.
Ak chcete vedieť čo sa počas jednotlivých krokov odohráva, preštudujte si príslušné funkcie.
For instance, as of this writing the definition of @code{unpack} for the GNU build system is:
Napríklad, v čase písania týchto riadkov, bolo zadanie kroku @code{unpack} v zostavovacom systéme GNU nasledovné:
(define* (unpack #:key source #:allow-other-keys)
"Unpack SOURCE in the working directory, and change directory within the
source. When SOURCE is a directory, copy it in a sub-directory of the current
working directory."
(if (file-is-directory? source)
(begin
(mkdir "source")
(chdir "source")
(define* (unpack #:key source #:allow-other-keys)
"Unpack SOURCE in the working directory, and change directory within the
source. When SOURCE is a directory, copy it in a sub-directory of the current
working directory."
(if (file-is-directory? source)
(begin
(mkdir "source")
(chdir "source")
;; Preserve timestamps (set to the Epoch) on the copied tree so that
;; things work deterministically.
(copy-recursively source "."
#:keep-mtime? #true))
(begin
(if (string-suffix? ".zip" source)
(invoke "unzip" source)
(invoke "tar" "xvf" source))
(chdir (first-subdirectory "."))))
#true)
;; Preserve timestamps (set to the Epoch) on the copied tree so that
;; things work deterministically.
(copy-recursively source "."
#:keep-mtime? #true))
(begin
(if (string-suffix? ".zip" source)
(invoke "unzip" source)
(invoke "tar" "xvf" source))
(chdir (first-subdirectory "."))))
#true)
Note the @code{chdir} call: it changes the working directory to where the source was unpacked. Thus every phase following the @code{unpack} will use the source as a working directory, which is why we can directly work on the source files. That is to say, unless a later phase changes the working directory to something else.
Všimnite si volanie @code{chdir}: zmení súčasný priečinok na umiestnenie, kde boli rozbalené zdrojové súbory. To znamená, že kroky nasledujúce po @code{unpack} použijú priečinok so zdrojovými súbormi ako ich pracovný priečinok. Preto môžeme priamo narábať so zdrojovými súbormi. Teda aspoň dovtedy, kým niektorý ďalší krok nezmení pracovný priečinok na iný.
We modify the list of @code{%standard-phases} of the build system with the @code{modify-phases} macro as per the list of specified modifications, which may have the following forms:
Zoznam krokov @code{%standard-phases} zostavovacieho systému upravujeme pomocou makra @code{modify-phases} určujúceho aké úpravy sa majú vykonať, čo môže vyzerať asi takto:
@code{(add-before @var{phase} @var{new-phase} @var{procedure})}: Run @var{procedure} named @var{new-phase} before @var{phase}.
@code{(add-before @var{krok} @var{novy-krok} @var{funkcia})}: Spustiť @var{funkcia} s názvom @var{novy-krok} pred @var{krok}.
@code{(add-after @var{phase} @var{new-phase} @var{procedure})}: Same, but afterwards.
@code{(add-after @var{krok} @var{novy-krok} @var{funkcia})}: Tak isto, ale za @var{krok}.
@code{(replace @var{phase} @var{procedure})}.
@code{(replace @var{krok} @var{funkcia})}.
@code{(delete @var{phase})}.
@code{(delete @var{krok})}.
The @var{procedure} supports the keyword arguments @code{inputs} and @code{outputs}. Each input (whether @emph{native}, @emph{propagated} or not) and output directory is referenced by their name in those variables. Thus @code{(assoc-ref outputs "out")} is the store directory of the main output of the package. A phase procedure may look like this:
@var{Funkcia} prijíma parametre @code{inputs} a @code{outputs} v tvare kľúčových slov. Každý vstup (či už @emph{pôvodný}, @emph{rozšírený} alebo nie) a výstupný priečinok je označený svojim názvom v týchto premenných. Takže @code{(assoc-ref outputs "out")} predstavuje priečinok úložiska hlavného výstupu balíka. Funkcia kroku vyzerá nasledovne:
(lambda* (#:key inputs outputs #:allow-other-keys)
(let ((bash-directory (assoc-ref inputs "bash"))
(output-directory (assoc-ref outputs "out"))
(doc-directory (assoc-ref outputs "doc")))
;; ...
#true))
(lambda* (#:key inputs outputs #:allow-other-keys)
(let ((bash-directory (assoc-ref inputs "bash"))
(output-directory (assoc-ref outputs "out"))
(doc-directory (assoc-ref outputs "doc")))
;; ...
#true))
The procedure must return @code{#true} on success. It's brittle to rely on the return value of the last expression used to tweak the phase because there is no guarantee it would be a @code{#true}. Hence the trailing @code{#true} to ensure the right value is returned on success.
Funkcia musí po úspešnom vykonaní vrátiť @code{#true}. Nie je veľmi spoľahlivé opierať sa o návratovú hodnotu posledného výrazu keďže nie je isté, že to bude práve @code{#true}. Koncové @code{#true} zaisťuje, že bude po úspešnom vykonaní vrátená správna hodnota.
Code staging
Oddialené vykonanie
The astute reader may have noticed the quasi-quote and comma syntax in the argument field. Indeed, the build code in the package declaration should not be evaluated on the client side, but only when passed to the Guix daemon. This mechanism of passing code around two running processes is called @uref{https://arxiv.org/abs/1709.00833, code staging}.
Ak ste boli pozorní, mohli ste si všimnúť obrátenú úvodzovku a čiarku v poli parametrov. Vskutku, zdrojový kód zostavenia v zadaní balíka by sa nemal vykonávať na strane klienta, ale až vtedy, keď sa odovzdá démonovi Guixu. Toto odovzdávanie zdrojového kódu medzi dvoma procesmi nazývame @uref{https://arxiv.org/abs/1709.00833, oddialené vykonanie}.
Utility functions
Pomocné funkcie
When customizing @code{phases}, we often need to write code that mimics the equivalent system invocations (@code{make}, @code{mkdir}, @code{cp}, etc.)@: commonly used during regular ``Unix-style'' installations.
Pri prispôsobovaní @code{phases} budete často potrebovať funkcie zodpovedajúce systémovým volaniam (@code{make}, @code{mkdir}, @code{cp}, atď.), ktoré sú zvyčajne dostupné na Unixových systémoch.
Some like @code{chmod} are native to Guile. @xref{,,, guile, Guile reference manual} for a complete list.
Niektoré z nich, ako napríklad @code{chmod}, sú priamo dostupné v jazyku Guile. Viď úplný zoznam v @xref{,,, guile, Guile reference manual}.
Guix provides additional helper functions which prove especially handy in the context of package management.
Guix poskytuje ďalšie pomocné funkcie, užitočné najmä v súvislosti so správou balíkov.
Some of those functions can be found in @samp{$GUIX_CHECKOUT/guix/guix/build/utils.scm}. Most of them mirror the behaviour of the traditional Unix system commands:
Niektoré z týchto funkcií sa nachádzajú v @samp{$GUIX_CHECKOUT/guix/guix/build/utils.scm}. Väčšinou napodobňujú správanie pôvodných Unixových systémových príkazov:
which
which
Like the @samp{which} system command.
Rovnaká ako systémový príkaz @samp{which}.
find-files
find-files
Akin to the @samp{find} system command.
Podobná príkazu @samp{find}.
mkdir-p
mkdir-p
Like @samp{mkdir -p}, which creates all parents as needed.
Rovnaká ako príkaz @samp{mkdir -p}, ktorý v prípade potreby vytvorí aj všetky nadradené priečinky.

Loading…

User avatar felsoci

Comment added

  1. guix
  2. documentation-cookbook
  3. Slovak

Thanks for pointing it out. Fixed.

9 months ago
User avatar felsoci

Translation changed

  1. guix
  2. documentation-cookbook
  3. Slovak
The @var{procedure} supports the keyword arguments @code{inputs} and @code{outputs}. Each input (whether @emph{native}, @emph{propagated} or not) and output directory is referenced by their name in those variables. Thus @code{(assoc-ref outputs "out")} is the store directory of the main output of the package. A phase procedure may look like this:
@var{Funkcia} podporujerijíma parametre @code{inputs} a @code{outputs} v tvare kľúčových slov. Každý vstup (či už @emph{pôvodný}, @emph{rozšírený} alebo nie) a výstupný priečinok je označený svojim názvom v týchto premenných. Takže @code{(assoc-ref outputs "out")} predstavuje priečinok úložiska hlavného výstupu balíka. Funkcia kroku vyzerá nasledovne:
a year ago
User avatar felsoci

Translation changed

  1. guix
  2. documentation-cookbook
  3. Slovak
The @var{procedure} supports the keyword arguments @code{inputs} and @code{outputs}. Each input (whether @emph{native}, @emph{propagated} or not) and output directory is referenced by their name in those variables. Thus @code{(assoc-ref outputs "out")} is the store directory of the main output of the package. A phase procedure may look like this:
@var{Funkcia} podporuje parametre @code{inputs} a @code{outputs} v tvare kľúčových slov. Každý vstup (či už @emph{pôvodný}, @emph{rozšírený} alebo nie) a výstupný priečinok je označený svojim názvom v týchto premenných. Takže @code{(assoc-ref outputs "out")} predstavuje priečinok úložiska hlavného výstupu balíka. Funkcia kroku vyzerá nasledovne:
2 years ago
User avatar roptat

Comment added

  1. guix
  2. documentation-cookbook
  3. Slovak

The markup is incorrect: "@{Funkcia}", it should be @var. This is a fatal error for texinfo.

2 years ago
User avatar felsoci

Translation added

  1. guix
  2. documentation-cookbook
  3. Slovak
The @var{procedure} supports the keyword arguments @code{inputs} and @code{outputs}. Each input (whether @emph{native}, @emph{propagated} or not) and output directory is referenced by their name in those variables. Thus @code{(assoc-ref outputs "out")} is the store directory of the main output of the package. A phase procedure may look like this:
@{Funkcia} podporuje parametre @code{inputs} a @code{outputs} v tvare kľúčových slov. Každý vstup (či už @emph{pôvodný}, @emph{rozšírený} alebo nie) a výstupný priečinok je označený svojim názvom v týchto premenných. Takže @code{(assoc-ref outputs "out")} predstavuje priečinok úložiska hlavného výstupu balíka. Funkcia kroku vyzerá nasledovne:
2 years ago
Browse all string changes
User avatar roptat

Translation comment

The markup is incorrect: "@{Funkcia}", it should be @var. This is a fatal error for texinfo.

2 years ago
User avatar felsoci

Translation comment

Thanks for pointing it out. Fixed.

9 months ago

Things to check

Comments

There are 2 unresolved comments for this string.

View

Glossary

English Slovak
input vstup guix Glossary

Ak balík B závisí na balíku A, hovoríme, že balík a je vstup balíka B.
output výstup guix Glossary
package balík guix Glossary
store úložisko guix Glossary

String information

Source string description
type: Plain text
Source string location
guix-git/doc/guix-cookbook.texi:1321
String age
3 years ago
Last updated
yesterday
Source string age
3 years ago
Translation file
po/doc/guix-cookbook.sk.po, string 359